home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1995 May / cd Ware (Juegos) Epimundo.iso / DOS / TOOLS / INSTALIT.ZIP / INSTALL.DOC < prev    next >
Encoding:
Text File  |  1993-12-30  |  72.5 KB  |  1,830 lines

  1.  
  2.    ╔════════════════════════════════════════════════════════════════════════╗
  3.    ║                              INSTALL IT!                               ║
  4.    ║                      General Installation Utility                      ║
  5.    ║                                                                        ║
  6.    ║                             Version 2.08                               ║
  7.    ╟────────────────────────────────────────────────────────────────────────╢
  8.    ║                               group.m                                  ║
  9.    ║                         5800 Blue Spruce Ave.                          ║
  10.    ║                        Alamosa, CO  81101-9738                         ║
  11.    ║                            (719) 589-6602                              ║
  12.    ╚════════════════════════════════════════════════════════════════════════╝
  13.                   Copyright 1993 group.m.  All rights reserved.
  14.  
  15.      You may use this product at no charge, but you must register.  See
  16.      section "XI Registration".
  17.  
  18.                                     Contents
  19.  
  20.             I    General Information..............................2
  21.             II   Trying INSTALL IT! for the First Time............3
  22.             III  Using INSTALL IT!................................4
  23.             IV   Command Syntax...................................8
  24.             V    Examples........................................13
  25.             VI   Technical Notes.................................18
  26.             VII  English Error Messages..........................21
  27.             VIII German Error Messages...........................25
  28.             IX   Distribution....................................27
  29.             X    Customization...................................28
  30.             XI   Registration....................................29
  31.  
  32.  
  33.  
  34.      Your logo can appear as the background for INSTALL.EXE!  The pink
  35.      "group.m" background can be changed to the logo of your company or
  36.      product.  A plain background version of INSTALL.EXE IS also available.
  37.      See section "X Customization" for more information.
  38.  
  39.      This document is the reference manual for INSTALL IT!.  It contains
  40.      information on using, distributing, customizing, and registering
  41.      INSTALL IT!.  If you have questions or problems that aren't addressed in
  42.      this manual, call group.m or write to the address at the top of this
  43.      page.
  44.  
  45.      This product is distributed "as is".  Group.m disclaims any warranties
  46.      express or implied, including but not limited to, any implied warranty
  47.      of merchantability or fitness for a particular purpose.  Specifically,
  48.      group.m makes no warranty that this software is fit for any particular
  49.      purpose.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                        1
  60.  
  61. I    General Information
  62.  
  63.      Overview
  64.  
  65.           An installation procedure that is fast and easy can make or break
  66.           a software product.  Many people develop batch files to install
  67.           their software.  These batch files can be slow, and they don't
  68.           offer a very "friendly" end-user interface.  We developed INSTALL
  69.           IT! to provide a fast, easy to use, and professional looking method
  70.           for installing your software products.
  71.  
  72.           INSTALL IT! provides a general installation program, INSTALL.EXE,
  73.           designed to transfer software from diskettes to a fixed disk.
  74.           INSTALL.EXE performs generic installation functions that can be
  75.           tailored to your specific needs.  INSTALL.EXE reads a script file
  76.           which controls the order and type of installation actions that will
  77.           be performed.
  78.  
  79.           INSTALL IT! has a number of uses.  If you develop software,
  80.           INSTALL IT! can be used to create distribution diskettes for your
  81.           products; if you are an IS manager, INSTALL IT! can be used to
  82.           create simple installation diskettes for distributing software or
  83.           data to your customers.  In any case, INSTALL IT! provides you
  84.           with the tools to develop installation disks that will start your
  85.           customers off with a good impression of your product.
  86.  
  87.      History
  88.  
  89.           INSTALL IT! was originally developed for the internal use of
  90.           group.m.  As time passed, other people asked to use INSTALL IT!;
  91.           and, as more and more people began using INSTALL IT! we decided to
  92.           put together this manual explaining how the product works.
  93.  
  94.           We have received such a positive response from those who use
  95.           INSTALL IT! that we now make the product available to the general
  96.           public.
  97.  
  98.           Each new version of INSTALL IT! contains improvements that have
  99.           been suggested by people, like you, who use the product.  For
  100.           information about the new features in this version, see section
  101.           "VI Technical Notes" of this manual.
  102.  
  103.      Your responsibilities
  104.  
  105.           We are committed to the goals of supporting and improving this
  106.           product.  To accomplish these goals, we need to know how INSTALL
  107.           IT! is being used, and what we can to do to make it better.
  108.           Group.m wants to hear from you.  Please read section "XI
  109.           Registration" to find out how to register with us, and how to
  110.           contact us with your ideas for improving this product.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                        2
  119.  
  120. II   Trying INSTALL IT! for the First Time
  121.  
  122.      If you are not familiar with the INSTALL IT! product, you may want to
  123.      take a "test drive" of the product.
  124.  
  125.      To try out INSTALL IT!, be sure that the files INSTALL.EXE and
  126.      INSTALL.DAT are located on the same drive and directory of your
  127.      computer.  Run INSTALL.EXE from a DOS prompt and the files that make up
  128.      INSTALL IT! will be copied from one disk to another.
  129.  
  130.      For example, if you have this product on a diskette in your A: drive,
  131.      you would type A:INSTALL at a DOS prompt, and the whole product would be
  132.      copied to your fixed disk drive C: in the subdirectory \INSTALIT (you
  133.      will have the option of specifying a different destination during this
  134.      process).
  135.  
  136.      More information on the sample installation script (INSTALL.DAT) is
  137.      supplied in the section "V Examples".
  138.  
  139.      If you wan to see a demonstration of the German language version of
  140.      INSTALL IT!, use the command "INSTALLG INSTALLG.DAT" at a DOS prompt.
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                        3
  178.  
  179. III  Using INSTALL IT!
  180.  
  181.      Overview
  182.  
  183.           INSTALL IT! provides the program INSTALL.EXE which is a script
  184.           driven installation utility designed to transfer your programs and
  185.           files from diskettes to fixed disks.  INSTALL.EXE follows a script
  186.           (usually contained in the file INSTALL.DAT) and takes various
  187.           actions such as creating directories and copying files.
  188.  
  189.           INSTALL.EXE runs under DOS and presents a professional, windowed
  190.           interface to the end-user.  It supports both the keyboard and the
  191.           mouse.  INSTALL.EXE allows you to create windows explaining your
  192.           product and the installation procedure, as well as dialogs which
  193.           allow the end-user to make choices during the installation process.
  194.  
  195.           You will develop your own script files tailored to your specific
  196.           installation.  The script file(s) should be ordinary ASCII text
  197.           files that can be created with most word processors.  As you
  198.           develop script files, you can run INSTALL.EXE with the /SCAN
  199.           parameter to check the syntax of the script.
  200.  
  201.           A script file contains one or more commands that follow a specific
  202.           syntax.  These commands are executed sequentially in the order they
  203.           appear in the script file.
  204.  
  205.           INSTALL.EXE is designed to execute a full script from beginning to
  206.           end.  Some scripts allow the user to halt the installation process.
  207.           If a user halts the installation, INSTALL.EXE stops immediately and
  208.           does not process the rest of the script.  For example, a prompt
  209.           might be displayed that the product to be installed already exists
  210.           and the user is asked if they wish to overwrite the old copy of the
  211.           product.  If the user selects "Yes" ("Ja") INSTALL.EXE will
  212.           continue; if the user selects "No" ("Nein") INSTALL.EXE halts and
  213.           displays the message "INSTALL canceled" ("abgebrochen").
  214.  
  215.           If a syntax error occurs during the execution of a script,
  216.           INSTALL.EXE terminates and displays an error dialog.  The dialog
  217.           contains one of the error messages listed in section "VII English
  218.           Error Messages" or section "VIII German Error Messages", the line
  219.           number and file name of the script file, and the text of the line
  220.           containing the error.
  221.  
  222.           When you have completed your script, you will include it with the
  223.           program INSTALL.EXE on your installation disks.  Be sure to
  224.           thoroughly test your script files.
  225.  
  226.           INSTALL.EXE is executed from the DOS prompt.  Two parameters can
  227.           be included on the command line.  The first is the name of the
  228.           script file.  If no file is specified, INSTALL.EXE will look for
  229.           the file INSTALL.DAT on the disk containing INSTALL.EXE.  Any file
  230.           may be specified on the command line, and if no file extension is
  231.           given, DAT is assumed.  The second parameter is /S or /SCAN.  This
  232.           parameter will cause INSTALL.EXE to scan the script file for syntax
  233.           errors and is intended for use while debugging script files.
  234.  
  235.  
  236.                                        4
  237.  
  238.           INSTALL.EXE may be customized to display your organization's logo
  239.           in place of the pink "group.m" logo.  A plain background version of
  240.           INSTALL.EXE IS also available.  For more information on
  241.           customization see section "X Customization".
  242.  
  243.      Script Files
  244.  
  245.           When you make distribution diskettes with INSTALL IT!, you need to
  246.           include two files along with the files you wish to install.  These
  247.           are:
  248.  
  249.                INSTALL.DAT - you will create this,
  250.                INSTALL.EXE - copied exactly from this disk or, for the German
  251.                              language version, copied from INSTALLG.EXE on
  252.                              this disk.
  253.  
  254.           INSTALL.EXE should reside on the first of your distribution
  255.           diskettes.  You will also need to create INSTALL.DAT on that
  256.           diskette.
  257.  
  258.           INSTALL.DAT should be a text file containing one or more
  259.           installation commands.  These commands may contain spaces for
  260.           readability and may span more than one line.
  261.  
  262.           Comments may be included in scripts.  Comments follow a semicolon
  263.           (";") and may contain any text.  Comments may be placed on the same
  264.           line as other commands, or they may stand alone.  All text
  265.           from the semicolon to the end of the line is treated as a comment
  266.           even if the line contains valid INSTALL IT! commands.
  267.  
  268.           Labels are used to alter the flow of execution in a script.  Label
  269.           names may be up to 13 characters long and may contain letters
  270.           (upper and lower case), numbers, and special characters.  Labels
  271.           should not contain spaces or the characters "(", ")", "+", "<",
  272.           ";", and ">".  Labels must be terminated by the character ":".  An
  273.           example would be "Label1:".
  274.  
  275.           Generally installation commands consist of a command verb followed
  276.           by one or more parameters.  For example, the structure for the
  277.           APPEND command (APPEND will add text to the end of a file) is:
  278.  
  279.                "APPEND(string_expression > file_name)",
  280.  
  281.           where "APPEND" is the command verb, "string_expression" and
  282.           "file_name" are parameters, and the special characters "(", ">",
  283.           and ")" are a fixed part of the command structure.
  284.  
  285.           Command parameters will contain a variety of information, such as
  286.           file names, disk names or prompts to be displayed on the screen.
  287.           Parameters may be either literals or variables (or a combination of
  288.           both), where a literal contains the actual (literal) value of the
  289.           parameter, and a variable is a reference to a value that has been
  290.           determined earlier.
  291.  
  292.  
  293.  
  294.  
  295.                                        5
  296.  
  297.           Literals should be enclosed in quotes (single or double).  Examples
  298.           of literals are: 'Enter a DOS path.', and "C:\AUTOEXEC.BAT"; where
  299.           the first contains the text for a prompt, and the second contains
  300.           the name of a file.  You must use the same type of quote to start
  301.           and end the literal, but it does not matter which one you use. For
  302.           example: "literal" and 'literal' are equivalent but "literal' is
  303.           not valid.
  304.  
  305.           Variables are referenced by their name.  A variable name may be up
  306.           to 30 characters long and may contain letters (upper and lower
  307.           case), numbers, and special characters.  Variable names should not
  308.           contain spaces or the characters "(", ")", "+", "<", ";", and ">".
  309.           Two variables are pre-defined: INSTALLPATH and COMSPEC.
  310.           INSTALLPATH contains the DOS path where INSTALL.EXE is located.
  311.           COMSPEC contains the path and name (from the DOS environment) of
  312.           the command interpreter.  For more information on the command
  313.           interpreter consult your DOS manuals.  You may create other
  314.           variables as needed.
  315.  
  316.           In forming command parameters, literals and variables may be
  317.           concatenated (joined together) by using the plus character "+".
  318.           For example, if the variable PATH contained the value "C:\" and the
  319.           variable FILE contained "AUTOEXEC.BAT", PATH + FILE would be
  320.           equivalent to "C:\AUTOEXEC.BAT".
  321.  
  322.           Command parameters fall into one of the following types:
  323.  
  324.                commandtail  - this designates command line parameters for a
  325.                               DOS program,
  326.  
  327.                diskname     - this should be the name you supply for a prompt
  328.                               such as "Disk 1",
  329.  
  330.                filename     - this should name a valid DOS filename;  it may
  331.                               also contain a path;  for more information on
  332.                               filenames, see your DOS manuals,
  333.  
  334.                label        - this text (expressed as a literal or contained
  335.                               in a variable) refers to a label somewhere in
  336.                               the script file,
  337.  
  338.                path         - this parameter should contain a valid DOS path;
  339.                               for more information on paths, see your DOS
  340.                               manuals,
  341.  
  342.                prompt       - this should contain text to be displayed on the
  343.                               screen during the installation,
  344.  
  345.                text         - this can be any text (expressed as a literal or
  346.                               contained in a variable), or
  347.  
  348.                variablename - this is the name of a variable.
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                        6
  355.  
  356.           The following commands are available for use in script files.
  357.  
  358.                APPEND        - adds a line of text to the end of a file,
  359.  
  360.                ASSIGN        - assigns a value to a variable,
  361.  
  362.                ASSIGNDRIVE   - assigns the drive of a path/filename to a
  363.                                variable,
  364.  
  365.                BRANCHIFEXIST - alters the script file flow of control based
  366.                                on the existence of a file,
  367.  
  368.                BRANCHTO      - unconditionally alters the script file flow of
  369.                                control,
  370.  
  371.                CHDIR         - changes the DOS default directory,
  372.  
  373.                DOSCOMMAND    - executes a DOS program,
  374.  
  375.                GETPATH       - displays a window to enter and change paths,
  376.  
  377.                HIDELINES     - removes text windows from the screen,
  378.  
  379.                INSTALL       - executes another script file,
  380.  
  381.                NEWDISK       - prompts for a new diskette to be mounted,
  382.  
  383.                PROMPTPATH    - prompts for the creation or use of a path,
  384.  
  385.                REMOVE        - deletes a file,
  386.  
  387.                SHOWLINES     - displays a text window on the screen,
  388.  
  389.                TITLE         - sets the title for the pop-up windows, and
  390.  
  391.                TRANSFER      - copies files from the diskette to the fixed
  392.                                disk.
  393.  
  394.           More information on each command is available in section "IV
  395.           Command Syntax"
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                        7
  414.  
  415. IV   Command Syntax
  416.  
  417.      Each command verb and its syntax is listed below along with one or two
  418.      examples of its use.  For more information on parameter types (text,
  419.      filename, etc.) see section "III Using INSTALL IT!".
  420.  
  421.  
  422.      APPEND - Adds a line of text to the end of a file.
  423.  
  424.           Syntax: APPEND(text > filename)
  425.  
  426.           Example: APPEND("FILES=100" > "C:\CONFIG.SYS") would add the line
  427.                "FILES=100" to the end of the system configuration file.
  428.  
  429.  
  430.      ASSIGN - Assigns a value to a variable.
  431.  
  432.           Syntax: ASSIGN(variablename < text)
  433.  
  434.           Example: ASSIGN(NEWPATH < 'D:\DEST') would give the variable
  435.                NEWPATH the value "D:\DEST".
  436.  
  437.  
  438.      ASSIGNDRIVE - Assigns the drive of a path or filename to a variable.
  439.  
  440.           Syntax: ASSIGNDRIVE(variablename < path)
  441.  
  442.           Examples: ASSIGNDRIVE(NEWDRIVE < 'C:\DOS') would give NEWDRIVE the
  443.                value "C:".
  444.  
  445.                ASSIGNDRIVE(NEWDRIVE < INSTALLPATH) would assign the drive
  446.                containing INSTALL.EXE to the variable NEWDRIVE.  Notice that
  447.                this will not give NEWDRIVE and INSTALLPATH the same value.
  448.                INSTALLPATH will contain a fully qualified DOS path, and
  449.                NEWDRIVE will only contain a DOS drive designator.
  450.  
  451.  
  452.      BRANCHIFEXIST - Alters the script file flow of control based on the
  453.                      existence of a file.
  454.  
  455.           Syntax: BRANCHIFEXIST(filename, label)
  456.  
  457.           Example: BRANCHIFEXIST('C:\AUTOEXEC.BAT', 'CHECKBAT') would branch
  458.                to the label CHECKBAT in the script file if the file
  459.                C:\AUTOEXEC.BAT exists.  If C:\AUTOEXEC.BAT does not exist
  460.                processing of the script file would continue with the next
  461.                sequential command.
  462.  
  463.  
  464.      BRANCHTO - Unconditionally alters the script file flow of control.
  465.  
  466.           Syntax: BRANCHTO(label)
  467.  
  468.           Example: BRANCHTO('CHECKBAT') would branch to the label CHECKBAT
  469.                in the script file.
  470.  
  471.  
  472.                                        8
  473.  
  474.      CHDIR - Changes the DOS default directory.  For more information on
  475.           changing directories, see the CHDIR command in your DOS manuals.
  476.  
  477.           Syntax: CHDIR(path)
  478.  
  479.           Example: CHDIR(INSTALLPATH) would change the DOS default path
  480.                to the location of INSTALL.EXE.
  481.  
  482.  
  483.      DOSCOMMAND - Executes a DOS program.  When the program terminates,
  484.           control returns to INSTALL.EXE.
  485.  
  486.           Syntax: DOSCOMMAND(filename, commandtail)
  487.  
  488.           Examples: DOSCOMMAND(COMSPEC, "/CDIR") would run the command
  489.                processor and pass the command tail "/CDIR", displaying
  490.                a listing of the current DOS directory.  This is equivalent
  491.                to typing "COMMAND /CDIR" at a DOS prompt.
  492.  
  493.                DOSCOMMAND(INSTALLPATH + '\INIT.EXE', "/T") would execute the
  494.                program named INIT.EXE from the installation diskette and pass
  495.                it the command tail "/T".  Assuming that the installation disk
  496.                is in drive A:, this would be equivalent to typing
  497.                "A:\INIT /T" at the DOS prompt.
  498.  
  499.  
  500.      GETPATH - Displays a window to enter and change paths.  GETPATH fully
  501.           qualifies paths and removes any trailing backslash (/) from the
  502.           path.
  503.  
  504.           Syntax: GETPATH(variablename) or
  505.                   GETPATH(variablename < path) or
  506.                   GETPATH(variablename (prompt)) or
  507.                   GETPATH(variablename < path (prompt))
  508.                GETPATH will also accept multiple prompts separated by commas.
  509.                For example:
  510.                     GETPATH(variablename < path (prompt),
  511.                             variablename < path (prompt),
  512.                             etc.)
  513.  
  514.           Examples: GETPATH(NEWPATH < INSTALLPATH ('Enter Data Path')) would
  515.                assign the value of INSTALLPATH to the variable NEWPATH,
  516.                display the prompt "Enter Data Path", display the value of
  517.                NEWPATH (which was initialized from INSTALLPATH), and allow
  518.                a new value to be entered.
  519.  
  520.                GETPATH(WORKPATH        < 'C:\TEMP' ('Enter Work Path'),
  521.                        DESTINATIONPATH < 'C:\DEST' ("Enter Destination Path"))
  522.                would display two prompts at the same time.
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.                                        9
  532.  
  533.      HIDELINES - Removes text windows from the screen.
  534.  
  535.           Syntax: HIDELINES('LAST') or
  536.                   HIDELINES('ALL')
  537.  
  538.           Example: HIDELINES('LAST') would remove the last text window
  539.                displayed with the "SHOWLINES('NOBUTTON',..." command.
  540.  
  541.                HIDELINES('ALL') would remove all text windows
  542.                displayed with the "SHOWLINES('NOBUTTON',..." command.
  543.  
  544.  
  545.      INSTALL - Executes another script file.  This command can be used to
  546.           switch execution to a script file that is not on the first
  547.           installation disk (for example a script file that has been copied
  548.           to the hard disk).  This is important for installations that span
  549.           more than one diskette.  Control does not return to the calling
  550.           script file after the called script terminates.
  551.  
  552.           Syntax: INSTALL(filename)
  553.  
  554.           Example: INSTALL('INSTALL2.DAT') would stop reading commands from
  555.                INSTALL.DAT and begin reading commands from INSTALL2.DAT.
  556.  
  557.  
  558.      NEWDISK - Prompts for a new diskette to be mounted, and optionally
  559.           checks for the existence of a file on the new diskette.
  560.  
  561.           Syntax: NEWDISK(diskname, path) or
  562.                   NEWDISK(diskname, path, filename)
  563.  
  564.           Examples: NEWDISK("Disk 2", INSTALLPATH) would display the prompt
  565.                "Insert Disk 2 in drive A:" (assuming that INSTALL.EXE was
  566.                executed from drive A:) and wait for a new diskette to be
  567.                mounted.
  568.  
  569.                NEWDISK("Disk 2", INSTALLPATH, 'TEST.FIL') would act like the
  570.                previous example then check for the existence of a TEST.FIL
  571.                on the path specified by INSTALLPATH.  The prompt would
  572.                be redisplayed until a disk containing TEST.FIL was mounted.
  573.  
  574.  
  575.      PROMPTPATH - Prompts for confirmation of the creation or use of a
  576.           directory.  If you want to create a path without prompting the
  577.           end-user, use the TRANSFER command.
  578.  
  579.           Syntax: PROMPTPATH(path, "EXIST") or
  580.                   PROMPTPATH(path, "NOTEXIST")
  581.  
  582.           Examples: PROMPTPATH("C:\TEMP", 'EXIST') would display the prompt
  583.                "C:\TEMP already exists. OK to overwrite" if the directory
  584.                already exists.  If C:\TEMP does not exist, no action is
  585.                taken.
  586.  
  587.                PROMPTPATH("C:\TEMP", 'NOTEXIST') would display the prompt
  588.  
  589.  
  590.                                        10
  591.  
  592.                "C:\TEMP does not exist.  OK to create?" if the directory does
  593.                not exist.  If C:\TEMP already exists no action is taken.
  594.  
  595.  
  596.      REMOVE - Deletes a file.
  597.  
  598.           Syntax: REMOVE(filename)
  599.  
  600.           Example: REMOVE("C:\AUTOEXEC.BAK") would delete the file
  601.                from the hard disk.
  602.  
  603.  
  604.      SHOWLINES - Displays a text window on the screen.  Text lines that start
  605.           with the ASCII character x03 (^C) will be centered in the window.
  606.  
  607.           Syntax: SHOWLINES('NOBUTTON', text) or
  608.                SHOWLINES('OK', text) or
  609.                SHOWLINES('OKQUIT', text)
  610.                SHOWLINES will also accept multiple lines of text separated by
  611.                commas.  For example:
  612.                     SHOWLINES('NOBUTTON', 'Text Line 1', 'Text Line 2')
  613.  
  614.           Examples: SHOWLINES('NOBUTTON', 'Welcome') would display a text
  615.                window at the top of the screen.  Once this window had been
  616.                displayed, the processing of the script file would continue
  617.                with the next sequential command.  The text window would
  618.                remain on the screen until a HIDELINES command was processed.
  619.                Multiple NOBUTTON windows may be displayed at the same time.
  620.                When a NOBUTTON window is displayed, any subsequent
  621.                windows will move down the screen to keep the NOBUTTON window
  622.                visible.
  623.  
  624.                SHOWLINES('OK', 'Welcome', 'Click the OK button to continue')
  625.                would display a text window in the center of the screen.  The
  626.                window would have a single "OK" button at the bottom.
  627.                Processing of commands in the script file would be suspended
  628.                until the button was clicked, or the ENTER key was pressed.
  629.  
  630.                SHOWLINES('OKQUIT', 'Welcome', 'Click the OK or Quit') would
  631.                display a text window in the center of the screen.  The
  632.                window would contain two buttons: "OK" and "Quit" ("Ende").
  633.                Processing of commands in the script file would be suspended
  634.                until a button was clicked, the ENTER key was pressed, or the
  635.                ESC key was pressed.
  636.  
  637.  
  638.      TITLE - Sets the title for the pop-up windows.
  639.  
  640.           Syntax: TITLE(text)
  641.  
  642.           Example: TITLE("Installation Demo") would place the title
  643.                "Installation Demo" at the top of each window that is
  644.                displayed during the installation.
  645.  
  646.  
  647.  
  648.  
  649.                                        11
  650.  
  651.      TRANSFER   - Copies files from the diskette to the fixed disk.  A
  652.          window showing the progress of the transfer is displayed on the
  653.          screen.  Multiple files may be transferred at the same time.
  654.          TRANSFER will accept filenames containing DOS wild card characters.
  655.          For more information on wild cards, see your DOS manuals.
  656.  
  657.          TRANSFER will create the destination path if it does not exist
  658.          without prompting the end-user.  Use PROMPTPATH if you want the user
  659.          to OK the creation of a path.
  660.  
  661.           Syntax: TRANSFER(filename > path)
  662.                TRANSFER will also accept multiple files separated by commas.
  663.                For example:
  664.                     TRANSFER(filename > path, filename > path, etc.)
  665.  
  666.           Examples: TRANSFER(INSTALLPATH + '\INSTALL.*' > WORKPATH) would
  667.                copy all files from the installation diskette that started
  668.                with INSTALL (INSTALL.EXE, INSTALL.DAT, etc.) to the path
  669.                designated by WORKPATH.
  670.  
  671.                TRANSFER(INSTALLPATH + '\INSTALL.*' > WORKPATH,
  672.                         INSTALLPATH + '\DEMO.EXE'  > WORKPATH + '\DEMO')
  673.                would work like the previous example then create a
  674.                subdirectory named DEMO off of the path in WORKPATH and copy
  675.                all files from the installation diskette that started with the
  676.                name DEMO to the new directory.
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.                                        12
  709.  
  710. V    Examples
  711.  
  712.      Study the following examples to get a better idea of how to use
  713.      INSTALL IT!.
  714.  
  715.  
  716.      Example 1:
  717.  
  718.           INSTALL IT! is distributed with a file named INSTALL.DAT.  This
  719.           script will copy the INSTALL IT! product to a fixed disk.  You may
  720.           wish to print this file so you can study it while you read the
  721.           explanation below.  This is the text of INSTALL.DAT:
  722.  
  723.           ┌────────────────────────────────────────────────────────────────┐
  724.           │ ;  *********************************************************** │
  725.           │ ;  **                                                       ** │
  726.           │ ;  **   INSTALL.DAT                                         ** │
  727.           │ ;  **                                                       ** │
  728.           │ ;  **   Copyright 1993 group.m                              ** │
  729.           │ ;  **                                                       ** │
  730.           │ ;  **   This file is a sample script file that is           ** │
  731.           │ ;  **   distributed with INSTALL IT!.  This file will copy  ** │
  732.           │ ;  **   the INSTALL IT! distribution files from a diskette  ** │
  733.           │ ;  **   (or directory) to another location.  For more       ** │
  734.           │ ;  **   information about this file, see the instructions   ** │
  735.           │ ;  **   contained in the file INSTALL.DOC.                  ** │
  736.           │ ;  **                                                       ** │
  737.           │ ;  *********************************************************** │
  738.           │                                                                │
  739.           │ Title('INSTALL IT! Sample Script')                             │
  740.           │                                                                │
  741.           │ ShowLines('OKQuit',                                            │
  742.           │           'Welcome to the sample installation script.',       │
  743.           │           '',                                                  │
  744.           │           'This script will copy the INSTALL IT! ' +           │
  745.           │                'product from a diskette',                      │
  746.           │           '(or directory) to another location and ' +          │
  747.           │                'demonstrate features of',                      │
  748.           │           'the INSTALL IT! product.',                          │
  749.           │           '',                                                  │
  750.           │           'To continue with the sample installation, click ' + │
  751.           │                'the OK button or ',                            │
  752.           │           'press ENTER.  To exit now, click the Quit ' +       │
  753.           │                'button or press ESC.')                         │
  754.           │                                                                │
  755.           │ ShowLines('OK',                                                │
  756.           │           'Notice that the background displayed behind ' +     │
  757.           │                'this dialog shows',                            │
  758.           │           'the group.m logo.  Custom versions of this ' +      │
  759.           │                'product are available',                        │
  760.           │           'which can display the logo of your company or ' +   │
  761.           │                'product.  A plain',                            │
  762.           │           'background version of this product (with no ' +     │
  763.           │                'logo) is also',                                │
  764.           │           'available.',                                        │
  765.           │           '',                                                  │
  766.  
  767.                                        13
  768.  
  769.           │           'For more information on custom backgrounds, see ' + │
  770.           │                'section "X',                                   │
  771.           │           'Customization" of the manual in the file ' +        │
  772.           │                'INSTALL.DOC supplied',                         │
  773.           │           'with this product.',                                │
  774.           │           '',                                                  │
  775.           │           'To continue, click the OK button or press ENTER.')  │
  776.           │                                                                │
  777.           │ ShowLines('NoButton',                                          │
  778.           │           'To continue this installation, you need to ' +      │
  779.           │                'decide where to',                              │
  780.           │           'locate the INSTALL IT! product.  The default ' +    │
  781.           │                'location is',                                  │
  782.           │           'C:\INSTALIT.  If this is acceptable, click the ' +  │
  783.           │                'OK button or press',                           │
  784.           │           'ENTER.  If you want to use another location, ' +    │
  785.           │                'type it in and',                               │
  786.           │           'press ENTER.')                                      │
  787.           │                                                                │
  788.           │ GetPath(DestinationPath <                                      │
  789.           │          'C:\INSTALIT' ('Enter destination for INSTALL IT!.')) │
  790.           │                                                                │
  791.           │ HideLines('Last')                                              │
  792.           │                                                                │
  793.           │ PromptPath(DestinationPath, 'Exist')                           │
  794.           │                                                                │
  795.           │ ShowLines('NoButton',                                          │
  796.           │           'Please wait while the INSTALL IT! files are ' +     │
  797.           │           'being copied....')                                  │
  798.           │                                                                │
  799.           │ Transfer(Installpath + '\*.*' > DestinationPath)               │
  800.           │                                                                │
  801.           │ HideLines('Last')                                              │
  802.           │                                                                │
  803.           │ ChDir(DestinationPath)                                         │
  804.           │                                                                │
  805.           │ ShowLines('NoButton',                                          │
  806.           │           'The sample installation is now complete.',         │
  807.           │           '',                                                  │
  808.           │           'The INSTALL IT! files have been copied to ' +      │
  809.           │                DestinationPath + '.',                          │
  810.           │           '',                                                  │
  811.           │           'The instructions for using INSTALL IT! are in ' +   │
  812.           │           'the file INSTALL.DOC.',                             │
  813.           │           'Be sure to read the sections on registration ' +    │
  814.           │                'and customization,',                           │
  815.           │           'and remember to register this product.')            │
  816.           └────────────────────────────────────────────────────────────────┘
  817.  
  818.           Lets go through each line of the script and look at what it does.
  819.  
  820.                The first several lines are comments.  They start with a
  821.                semicolon and contain information about the file.
  822.  
  823.                "Title('INSTALL IT! Sample Script')" sets the title
  824.                     that will appear at the top of each pop-up window.
  825.  
  826.                                        14
  827.  
  828.                Before the next command is executed, a copyright notice for
  829.                INSTALL.EXE is displayed.  The title at the top of the
  830.                copyright window contains the title set in the last command.
  831.  
  832.                "ShowLines('OKQuit',..." begins a block of lines that are all
  833.                     part of the SHOWLINES command.  This command displays
  834.                     a text window with information about the installation.
  835.                     The window contains two buttons: "OK" and "Quit"
  836.                     ("Ende").  If the "OK" button is pressed the installation
  837.                     will continue. If the "Quit" button is pressed, the
  838.                     installation terminates.
  839.  
  840.                "ShowLines('OK',..." begins a block of lines that are all
  841.                     part of the SHOWLINES command.  This command displays
  842.                     a text window with information about custom backgrounds
  843.                     for INSTALL IT!  The window contains the "OK" button.
  844.                     When the "OK" button is pressed the installation
  845.                     continues.
  846.  
  847.                "ShowLines('NoButton',..." begins another block of lines that
  848.                     make up a SHOWLINES command.  This command displays a
  849.                     text window that will remain on the screen while the next
  850.                     command (GETPATH) is executed.  The window contains no
  851.                     buttons.
  852.  
  853.                "GetPath(DestinationPath <..." displays a pop-up window that
  854.                     prompts for a path.  The text "Enter destination for
  855.                     INSTALL IT!" is displayed with the prompt and the input
  856.                     field is initialized with 'C:\INSTALIT'.
  857.  
  858.                "HideLines('Last')" removes the last text window from the
  859.                screen.  The window was displayed with SHOWLINES.
  860.  
  861.                "PromptPath(DestinationPath, 'Exist')" displays a pop-up
  862.                     window only if the path entered in the GETPATH window
  863.                     already exists.  The window displayed will ask if it is
  864.                     OK to overwrite the subdirectory.  The window contains
  865.                     two buttons: "Yes" ("Ja") and "No" ("Nein").  If "Yes"
  866.                     ("Ja") is pressed, the installation will continue; if
  867.                     "No" ("Nein") is pressed the installation terminates.
  868.  
  869.                "Transfer(Installpath + '\*.*' > DestinationPath)" copies all
  870.                     files from the installation path (the path from which
  871.                     INSTALL.EXE is being run) to the path entered in the
  872.                     GETPATH window.
  873.  
  874.                "ChDir(DestinationPath)" makes the path entered in the GETPATH
  875.                     window the DOS default directory.
  876.  
  877.                "ShowLines('NoButton',..." begins a block of lines that make
  878.                     up another SHOWLINES command.  This command displays a
  879.                     text window with a message that the installation is
  880.                     complete and urges the end-user to register this product.
  881.  
  882.                After the last line of the script is executed, a window with
  883.                the message "Install Completed" is displayed.
  884.  
  885.                                        15
  886.  
  887.      Example 2:
  888.  
  889.           This example would install an application called EXAMPLE2, create
  890.           a work directory, and modify a batch file.  This is the text that
  891.           would be in the script file:
  892.  
  893.           ┌────────────────────────────────────────────────────────────────┐
  894.           │ Title('EXAMPLE2 Installation')                                 │
  895.           │                                                                │
  896.           │ GetPath(SourcePath  <  InstallPath                             │
  897.           │                        ('Enter location of install disk'),     │
  898.           │         Destination < 'C:\EXAMPLE2'                            │
  899.           │                        ('Enter location to install EXAMPLE2'), │
  900.           │         WorkPath    < 'C:\EXAMPLE2\WORK'                       │
  901.           │                        ('Enter path for a work area'))         │
  902.           │                                                                │
  903.           │ PromptPath(Destination, 'Exist')                               │
  904.           │                                                                │
  905.           │ Transfer(SourcePath + '\EXAMPLE2.*' > Destination,             │
  906.           │          SourcePath + '\NOFILE'     > WorkPath)                │
  907.           │                                                                │
  908.           │ ASSIGNDRIVE(DestinationDrive < Destination)                    │
  909.           │                                                                │
  910.           │ BranchIfExist(Destination + '\SAMPLE.BAT', 'NoAppend')         │
  911.           │                                                                │
  912.           │ Append(DestinationDrive    > Destination + '\SAMPLE.BAT')      │
  913.           │ Append('cd ' + Destination > Destination + '\SAMPLE.BAT')      │
  914.           │ Append('EXAMPLE2'          > Destination + '\SAMPLE.BAT')      │
  915.           │                                                                │
  916.           │ NoAppend:                                                      │
  917.           │                                                                │
  918.           │ ChDir(Destination)                                             │
  919.           └────────────────────────────────────────────────────────────────┘
  920.  
  921.           Lets go through each line of the script and look at what it does.
  922.  
  923.                "Title('EXAMPLE2 Installation')" sets the title that
  924.                     will appear at the top of each pop-up window.
  925.  
  926.                Before the next command is executed, a copyright notice for
  927.                INSTALL.EXE is displayed.  The title at the top of the
  928.                copyright window contains the title set in the last command.
  929.  
  930.                "GetPath(SourcePath  <  InstallPath..." displays a pop-up
  931.                     window that prompts for three paths.  The text "Enter
  932.                     location of install disk" is displayed with the first
  933.                     prompt and the field is initialized with the location of
  934.                     INSTALL.EXE.  The text "Enter location to install
  935.                     EXAMPLE2" is displayed with the second prompt and the
  936.                     field is initialized with "C:\EXAMPLE2".  The text "Enter
  937.                     path for a work area" is displayed with the third prompt
  938.                     and the field is initialized with "C:\EXAMPLE2\WORK".
  939.  
  940.                "PromptPath(DestinationPath, 'Exist')" displays a pop-up
  941.                     window only if the path entered in the GETPATH window
  942.                     already exists.  The window displayed will ask if it is
  943.  
  944.                                        16
  945.  
  946.                     OK to overwrite the subdirectory.  The window contains
  947.                     two buttons: "Yes"("Ja") and "No" ("Nein").  If "Yes"
  948.                     ("Ja") is pressed, the installation will continue; if
  949.                     "No" ("Nein") is pressed the installation terminates.
  950.  
  951.                "Transfer(SourcePath + '\EXAMPLE2.*' > Destination,..." copies
  952.                     all files that match the mask EXAMPLE2.* from the
  953.                     SourcePath (as entered in the "GetPath" line) to the
  954.                     Destination.  It also attempts to copy NOFILE to the
  955.                     WorkPath. Assuming NOFILE doesn't exist, this creates the
  956.                     empty directory WorkPath without prompting the end-user.
  957.  
  958.                "ASSIGNDRIVE(DestinationDrive < Destination)" creates the
  959.                     variable DestinationDrive and initializes it with the
  960.                     drive of the Destination.
  961.  
  962.                "BranchIfExist(Destination + '\SAMPLE.BAT', 'NoAppend')"
  963.                     checks for the existence of "\SAMPLE.BAT" in the
  964.                     destination directory (from a previous installation).  If
  965.                     it exists, control is passed to the label "NoAppend"
  966.                     bypassing the next three APPEND commands.
  967.  
  968.                "Append(DestinationDrive    > Destination + '\SAMPLE.BAT')"
  969.                     is the first of three APPEND commands.  Each adds a line
  970.                     to the file SAMPLE.BAT in the Destination directory.  The
  971.                     first APPEND command will create SAMPLE.BAT.  When
  972.                     SAMPLE.BAT is later run, it will log on  to the
  973.                     DestinationDrive, change to the Destination directory,
  974.                     and execute EXAMPLE2.EXE.
  975.  
  976.                "ChDir(DestinationPath)" makes the path entered in the GETPATH
  977.                     window the DOS default directory.
  978.  
  979.                After the last line of the script is executed, a window with
  980.                the message "Install Completed" is displayed.
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.                                        17
  1004.  
  1005. VI   Technical Notes
  1006.  
  1007.      General
  1008.  
  1009.           When running INSTALL.EXE under a version of DOS less than 3.0, the
  1010.           path containing INSTALL.EXE can not be determined automatically.
  1011.           In this case, a pop-up window will be displayed at the beginning of
  1012.           the installation prompting for the path of the installation disk.
  1013.  
  1014.      Changes for version 2.06
  1015.  
  1016.           General:
  1017.  
  1018.                Reduced the size of the executable by 30K.  This will not only
  1019.                take up less room on your distribution disks, but will take up
  1020.                less memory (by the same 30K) when you are using the
  1021.                DOSCOMMAND command.
  1022.  
  1023.                Added the script file name and line number to the error
  1024.                dialog.  This will make it easier to find errors during script
  1025.                file testing.
  1026.  
  1027.                Removed the static help system, the file INSTALL.HLP, and the
  1028.                status line at the bottom of the screen.  The SHOWLINES command
  1029.                now lets you put your own instructions on every screen.
  1030.  
  1031.           Compatibility:
  1032.  
  1033.                Two changes were made in this version which might cause
  1034.                compatibility problems with scripts written for version 2.05.
  1035.  
  1036.                In the old version, if a second command followed an
  1037.                INSTALL command on the same line, the second command would be
  1038.                processed before control was passed to the new script file.
  1039.                This has been changed so that control is passed immediately.
  1040.  
  1041.                Also in the old version, if no explicit path was included in
  1042.                the REMOVE filename, the program would attempt to remove the
  1043.                file from the root directory.  Now it removes the file from
  1044.                the current directory.
  1045.  
  1046.           New features:
  1047.  
  1048.                INSTALL.EXE now supports comments in scripts.
  1049.  
  1050.                Four new script commands were added: BRANCHIFEXIST, BRANCHTO,
  1051.                HIDELINES, and SHOWLINES.
  1052.  
  1053.                INSTALL.EXE can now scan script files to search for errors.
  1054.  
  1055.                Script files may now have any valid file name.  They no longer
  1056.                have to end in DAT.
  1057.  
  1058.                Two command line parameters have been added: /SCAN (or /S) and
  1059.                the name of the script file to run.
  1060.  
  1061.  
  1062.                                        18
  1063.  
  1064.           Problems resolved:
  1065.  
  1066.                Fixed two problems with the INSTALL command.  The first
  1067.                occurred when the script file specified did not exist.  In
  1068.                this case the program would not end cleanly.  The second was
  1069.                never reported in the field - the program could cancel after
  1070.                an INSTALL command was successfully completed.
  1071.  
  1072.                Fixed two problems with the TRANSFER command.  The first
  1073.                occurred when an attempt was made to overwrite a read-only
  1074.                file.  In this situation the program would abort.  Now it
  1075.                prompts the user whether the read-only file should be
  1076.                overwritten.  The second problem occurred when a file was
  1077.                copied to itself - the program would report a failure.  Now it
  1078.                counts the file as being copied and continues on.
  1079.  
  1080.      Changes for version 2.07
  1081.  
  1082.           General:
  1083.  
  1084.                This version was an internal revision and was not released
  1085.                for general distribution.
  1086.  
  1087.           New features:
  1088.  
  1089.                Added support for the German language version.
  1090.  
  1091.      Changes for version 2.08
  1092.  
  1093.           General:
  1094.  
  1095.                Added logic to allow tab characters in script files.  Earlier
  1096.                versions returned an error message when tabs were encountered
  1097.                in scripts.  This version treats a tab as if it were spaces.
  1098.  
  1099.                The dialog displayed during the GETPATH command has been
  1100.                widened by 10 characters.  This will allow longer prompts
  1101.                to be displayed for each path.  Also, the dialogs that
  1102.                display static messages (Disk Full, Install Completed, etc.)
  1103.                have been widened by 10 characters.
  1104.  
  1105.           Compatibility:
  1106.  
  1107.                This version is compatible with all version 2.06 scripts.
  1108.  
  1109.           New features:
  1110.  
  1111.                Finalized support for the German language version. INSTALL.EXE
  1112.                can now display all buttons and messages in German.
  1113.  
  1114.                Added support for the plain background version of INSTALL IT!.
  1115.                INSTALL IT! is now available without the group.m logo in the
  1116.                background. See section "X Customization" for more
  1117.                information.
  1118.  
  1119.  
  1120.  
  1121.                                        19
  1122.  
  1123.           Problems resolved:
  1124.  
  1125.                Fixed a problem with the HIDELINES command.  This was problem
  1126.                was never reported in the field.  In theory, an installation
  1127.                could cancel itself after executing this command as if the
  1128.                text window being closed contained a "Quit" ("Ende") button
  1129.                and it had been pressed.
  1130.  
  1131.                Fixed a problem with script variables. Variables that had been
  1132.                assigned a value of '' (empty) would be assigned a random
  1133.                value when they were later referenced.  This problem was never
  1134.                reported in the field.
  1135.  
  1136.                Fixed a problem with the TRANSFER command.  If a DOS critical
  1137.                error (for example: the diskette was removed during copying or
  1138.                the diskette had a bad sector) was encountered during a
  1139.                transfer, you would be prompted to "Retry" or "Cancel".  If
  1140.                "Retry" was chosen, the installation would continue without
  1141.                error.  If "Cancel" was chosen, INSTALL.EXE would not end
  1142.                cleanly.  Now, when "Cancel" is chosen, the program is
  1143.                displays a dialog reporting that it has been canceled and ends
  1144.                cleanly.
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.                                        20
  1181.  
  1182. VII  English Error Messages
  1183.  
  1184.      When developing your own script files, you may occasionally encounter
  1185.      errors.  Be sure to thoroughly test your script files before
  1186.      distribution!  What follows is a list of the error messages you may
  1187.      encounter, and a short description of what they mean.
  1188.  
  1189.      "Directory does not exist"
  1190.  
  1191.           In a CHDIR command, you were attempting to change to a directory
  1192.           that does not exist.  Be sure to create the directory (with
  1193.           TRANSFER or PROMPTPATH) before changing to it.
  1194.  
  1195.      "Duplicate Label: xxx"
  1196.  
  1197.           The label "xxx" was found twice in the script file.  For more
  1198.           information on labels see section "III Using INSTALL IT!".
  1199.  
  1200.      "Invalid AssignDrive Path"
  1201.  
  1202.           In an ASSIGNDRIVE command, a valid path was not found after
  1203.           the "<".  For more information on paths see section "III Using
  1204.           INSTALL IT!".
  1205.  
  1206.      "Invalid BranchIfExist File Name"
  1207.  
  1208.           In a BRANCHIFEXIST command, the file name (the first parameter) was
  1209.           not a valid filename.  For more information on filenames see
  1210.           section "III Using INSTALL IT!".
  1211.  
  1212.      "Invalid BranchIfExist Label"
  1213.  
  1214.           In a BRANCHIFEXIST command, the label name (the second parameter)
  1215.           was not a valid label.  For more information on labels see
  1216.           section "III Using INSTALL IT!".
  1217.  
  1218.      "Invalid BranchTo Label"
  1219.  
  1220.           In a BRANCHTO command, the label name was not a valid label.  For
  1221.           more information on labels see section "III Using INSTALL IT!".
  1222.  
  1223.      "Invalid Command Tail"
  1224.  
  1225.           In a DOSCOMMAND command, a command tail was not found after
  1226.           the ",".
  1227.  
  1228.      "Invalid Data"
  1229.  
  1230.           In an APPEND command, you did not specify a valid text to append to
  1231.           the file.  For more information on text see section "III Using
  1232.           INSTALL IT!".
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.                                        21
  1240.  
  1241.      "Invalid Destination Path"
  1242.  
  1243.           In a TRANSFER command, you did not specify a valid path after the
  1244.           ">".  For more information on paths see section "III Using
  1245.           INSTALL IT!".
  1246.  
  1247.      "Invalid Disk Name"
  1248.  
  1249.           In a NEWDISK command, the disk name (the first parameter) was not
  1250.           a valid diskname.  For more information on disknames see section
  1251.           "III Using INSTALL IT!".
  1252.  
  1253.      "Invalid Disk Path"
  1254.  
  1255.           In a NEWDISK command, the disk path (the second parameter) was not
  1256.           a valid path.  For more information on paths see section "III Using
  1257.           INSTALL IT!".
  1258.  
  1259.      "Invalid Dos Command"
  1260.  
  1261.           In a DOSCOMMAND command, the DOS command (the first parameter) was
  1262.           not a valid filename.  For more information on filenames see
  1263.           section "III Using INSTALL IT!".
  1264.  
  1265.      "Invalid File Name"
  1266.  
  1267.           In an APPEND, NEWDISK, or REMOVE command, the file name was not a
  1268.           valid filename.  For more information on filenames see section
  1269.           "III Using INSTALL IT!".
  1270.  
  1271.      "Invalid Initial Value"
  1272.  
  1273.           In an ASSIGN or GETPATH command, you did not specify a valid
  1274.           value after the "<".
  1275.  
  1276.      "Invalid Install File Name"
  1277.  
  1278.           In an INSTALL command, you did not specify a valid DOS file name.
  1279.  
  1280.      "Invalid Parameter"
  1281.  
  1282.           In a HIDELINES, PROMPTPATH, or SHOWLINES command, the parameter you
  1283.           specified was not a valid text.  For more information on valid text
  1284.           see section "III Using INSTALL IT!".
  1285.  
  1286.      "Invalid Parameter: xxx"
  1287.  
  1288.           In a HIDELINES , PROMPTPATH, or SHOWLINES command, the parameter
  1289.           you specified "xxx" was not valid.  In a HIDELINES command, the
  1290.           parameter must be either "ALL" or "LAST".  In a PROMPTPATH command,
  1291.           the parameter must be either "EXIST" or "NOTEXIST".  In a SHOWLINES
  1292.           command, the parameter must be either "NOBUTTON", "OK", or
  1293.           "OKQUIT".
  1294.  
  1295.  
  1296.  
  1297.  
  1298.                                        22
  1299.  
  1300.      "Invalid Path Name"
  1301.  
  1302.           In a CHDIR or PROMPTPATH command, the path specified (the first
  1303.           parameter) was not valid.  For more information on paths see
  1304.           section "III Using INSTALL IT!".
  1305.  
  1306.      "Invalid Prompt"
  1307.  
  1308.           In a GETPATH command, the prompt contained in parenthesis was not
  1309.           valid.  For more information on valid text see section "III Using
  1310.           INSTALL IT!".
  1311.  
  1312.      "Invalid Source File Name"
  1313.  
  1314.           In a TRANSFER command, the source file name (the first parameter)
  1315.           was not a valid filename.  For more information on filenames see
  1316.           section "III Using INSTALL IT!".
  1317.  
  1318.      "Invalid Text"
  1319.  
  1320.           In a SHOWLINES command, the text (the second parameter or later) is
  1321.           not a valid text.  For more information on valid text see section
  1322.           "III Using INSTALL IT!".
  1323.  
  1324.      "Invalid Title"
  1325.  
  1326.           In a TITLE command, the text was not valid.  For more information
  1327.           on valid text see section "III Using INSTALL IT!".
  1328.  
  1329.      "Invalid Variable Name"
  1330.  
  1331.           In an ASSIGN, ASSIGNDRIVE, or GETPATH command, the variable name
  1332.           (the first parameter) was not a valid variablename.  For more
  1333.           information on variablenames see section "III Using INSTALL IT!".
  1334.  
  1335.      "Label: xxx not found."
  1336.  
  1337.           In a BRANCHIFEXIST or BRANCHTO command, the label (the second
  1338.           parameter in the BRANCHIFEXIST command) was not found in the script
  1339.           file.
  1340.  
  1341.      "Missing AssignDrive Path"
  1342.  
  1343.           In an ASSIGNDRIVE command, no path was specified after the "<".
  1344.  
  1345.      "Missing Assignment Value"
  1346.  
  1347.           In an ASSIGN command, no text was specified after the "<".
  1348.  
  1349.      "Unable to open xxx"
  1350.  
  1351.           In an INSTALL command, the file "xxx" could not be opened.  It does
  1352.           not exist, or it is being used by another process.
  1353.  
  1354.  
  1355.  
  1356.  
  1357.                                        23
  1358.  
  1359.      "Unable to run xxx"
  1360.  
  1361.           In a DOSCOMMAND command, the program "xxx" could not be executed.
  1362.           Be sure that "xxx" exists on the specified path.
  1363.  
  1364.      "Unrecognized Command"
  1365.  
  1366.           No valid command could be recognized.
  1367.  
  1368.      "Unrecognized Command: xxx"
  1369.  
  1370.           The command "xxx" is not one of the valid commands.
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.                                        24
  1417.  
  1418. VIII German Error Messages
  1419.  
  1420.      This section lists the cross references the German language error
  1421.      messages with the English messages.  When you find the error message
  1422.      you're looking for, go to section "VII English Error Messages" to find
  1423.      the explanation of the error.
  1424.  
  1425.      "Bezeichner: xxx nicht gefunden." refer to "Label: xxx not found."
  1426.  
  1427.      "Doppelter Bezeichner: xxx" refer to "Duplicate Label: xxx"
  1428.  
  1429.      "Fehlender AssignDrive Pfad" refer to "Missing AssignDrive Path"
  1430.  
  1431.      "Fehlender Zuweisungswert" refer to "Missing Assignment Value"
  1432.  
  1433.      "Unbekanntes Kommando" refer to "Unrecognized Command"
  1434.  
  1435.      "Unbekanntes Kommando: xxx" refer to "Unrecognized Command: xxx"
  1436.  
  1437.      "Ungültige Daten" refer to "Invalid Data"
  1438.  
  1439.      "Ungültige Eingabeaufforderung" refer to "Invalid Prompt"
  1440.  
  1441.      "Ungültige Parameter" refer to "Invalid Command Tail"
  1442.  
  1443.      "Ungültiger Anfangswert" refer to "Invalid Initial Value"
  1444.  
  1445.      "Ungültiger AssignDrive Pfad" refer to "Invalid AssignDrive Path"
  1446.  
  1447.      "Ungültiger BranchIfExist Bezeichner" refer to "Invalid BranchIfExist
  1448.      Label"
  1449.  
  1450.      "Ungültiger BranchIfExist Dateiname" refer to "Invalid BranchIfExist
  1451.      File Name"
  1452.  
  1453.      "Ungültiger BranchTo Bezeichner" refer to "Invalid BranchTo Label"
  1454.  
  1455.      "Ungültiger Dateiname" refer to "Invalid File Name"
  1456.  
  1457.      "Ungültiger Disk Name" refer to "Invalid Disk Name"
  1458.  
  1459.      "Ungültiger Disk Pfad" refer to "Invalid Disk Path"
  1460.  
  1461.      "Ungültiger Installations Dateiname" refer to "Invalid Install File
  1462.      Name"
  1463.  
  1464.      "Ungültiger Parameter" refer to "Invalid Parameter"
  1465.  
  1466.      "Ungültiger Parameter: xxx" refer to "Invalid Parameter: xxx"
  1467.  
  1468.      "Ungültiger Pfadname" refer to "Invalid Path Name"
  1469.  
  1470.      "Ungültiger Quell-Dateiname" refer to "Invalid Source File Name"
  1471.  
  1472.      "Ungültiger Text" refer to "Invalid Text"
  1473.  
  1474.  
  1475.                                        25
  1476.  
  1477.      "Ungültiger Titel" refer to "Invalid Title"
  1478.  
  1479.      "Ungültiger Variablenname" refer to "Invalid Variable Name"
  1480.  
  1481.      "Ungültiger Zielpfad" refer to "Invalid Destination Path"
  1482.  
  1483.      "Ungültiges Dos Kommando" refer to "Invalid Dos Command"
  1484.  
  1485.      "Verzeichnis existiert nicht" refer to "Directory does not exist"
  1486.  
  1487.      "xxx konnte nicht geöffnet werden" refer to "Unable to open xxx"
  1488.  
  1489.      "xxx konnte nicht gestartet werden" refer to "Unable to run xxx"
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.                                        26
  1535.  
  1536. IX   Distribution
  1537.  
  1538.      You may distribute the file INSTALL.EXE to allow installation of your
  1539.      own products without any fee or written license but you must register
  1540.      with group.m; see section "XI Registration".
  1541.  
  1542.      You may share the entire INSTALL IT! product with others provided you
  1543.      comply with the following conditions:
  1544.  
  1545.           1.   You must distribute all files that come with this product.
  1546.                If you received this program in an archived format (like ZIP)
  1547.                you must distribute the entire archive file or all files in
  1548.                the archive.
  1549.  
  1550.           2.   All files you distribute must be in their original, unaltered
  1551.                form.
  1552.  
  1553.           3.   If you charge a distribution fee, it may not exceed $10.
  1554.  
  1555.           4.   If you distribute this product on diskette, you must display
  1556.                the following copyright notice on the diskette label:
  1557.                "Copyright 1993 group.m".
  1558.  
  1559.      If you want to distribute this product in a manner that does not meet
  1560.      the conditions above, you must have written permission from group.m.
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.                                        27
  1594.  
  1595. X    Customization
  1596.  
  1597.      Custom versions of INSTALL.EXE are available for a one time fee.
  1598.      This fee entitles you to distribute as many copies of the custom version
  1599.      of INSTALL.EXE (the program only, not the documentation) as you wish.
  1600.      There are two custom versions available:
  1601.  
  1602.           1) Plain background
  1603.  
  1604.                Group.m sells a plain background version of INSTALL IT!.
  1605.                This version displays a pink background without the group.m
  1606.                logo, and is available for $40.00 + (US + $7.50 shipping and
  1607.                handling).  To order, fill out the order form at the bottom of
  1608.                this page and return to group.m with your payment.
  1609.  
  1610.           2) Custom background
  1611.  
  1612.                Group.m can change the background logo (the pink "group.m"
  1613.                that displays during installation) to display the logo of your
  1614.                organization or product.  Custom backgrounds are available for
  1615.                $150.00 (US + $7.50 shipping and handling).  More information
  1616.                on custom backgrounds can be obtained by checking the
  1617.                appropriate box on the registration or comment form, or
  1618.                contacting group.m at the address below.
  1619.  
  1620.  
  1621.                INSTALL IT! Customization
  1622.                group.m
  1623.                5800 Blue Spruce Ave.
  1624.                Alamosa, CO  81101-9738
  1625.  
  1626.                (719) 589-6602
  1627.  
  1628.    --------------------------------------------------------------------------
  1629.    ╔════════════════════════════════════════════════════════#IN2080006══════╗
  1630.    ║                                                                        ║
  1631.    ║  Order form for the plain background version of INSTALL IT! ver 2.08.  ║
  1632.    ║                                                                        ║
  1633.    ╟────────────────────────────────────────────────────────────────────────╢
  1634.    ║                                                                        ║
  1635.    ║                 Name: _______________________________   Date _________ ║
  1636.    ║                Title: _______________________________                  ║
  1637.    ║                                                                        ║
  1638.    ║         Company Name: _______________________________                  ║
  1639.    ║              Address: _______________________________                  ║
  1640.    ║                       _______________________________                  ║
  1641.    ║ City, State, and Zip: _______________________________                  ║
  1642.    ║                                                                        ║
  1643.    ║                Phone: (      )  _____________________                  ║
  1644.    ║                                                                        ║
  1645.    ╟────────────────────────────────────────────────────────────────────────╢
  1646.    ║                                                                        ║
  1647.    ║ Return this form with a check or money order (payable to group.m) in   ║
  1648.    ║ the amount of $47.50.  Please allow 2 to 4 weeks for delivery.         ║
  1649.    ║                                                                        ║
  1650.    ╚════════════════════════════════════════════════════════════════════════╝
  1651.  
  1652.                                        28
  1653.  
  1654. XI   Registration
  1655.  
  1656.      This product may be used "as is" with no license fee.
  1657.  
  1658.      We want to track where and how this product is used.  We ask that you
  1659.      notify us each time you distribute INSTALL.EXE.  Please don't register
  1660.      every copy of INSTALL.EXE you distribute; just register once for each
  1661.      different application of INSTALL.EXE.  If you are:
  1662.  
  1663.           a)   distributing your own software with INSTALL.EXE, please
  1664.                register once for each of your software products.
  1665.  
  1666.           b)   distributing data within your organization, register only
  1667.                once and estimate how many copies of INSTALL.EXE you are going
  1668.                to distribute.  If you later find that your estimate of the
  1669.                number of copies is inaccurate, please inform us of the actual
  1670.                figures.
  1671.  
  1672.      When you register, group.m will add you to our "user" list. If you
  1673.      indicate on the registration form that you want more information, we
  1674.      will notify you when new versions of INSTALL IT! are available, and send
  1675.      you information on other products we have available.
  1676.  
  1677.      Group.m welcomes any suggestions or comments you may have about this
  1678.      product.  Use the registration form to send comments if you are
  1679.      also registering this product; otherwise, use the comment form or call
  1680.      group.m.
  1681.  
  1682.      To register, complete the registration form below and mail to
  1683.  
  1684.           INSTALL IT! Registration
  1685.           group.m
  1686.           5800 Blue Spruce Ave.
  1687.           Alamosa, CO  81101-9738
  1688.  
  1689.           (719) 589-6602
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.                                        29
  1712.  
  1713.  
  1714.    ╔════════════════════════════════════════════════════════#IN2080006══════╗
  1715.    ║                                                                        ║
  1716.    ║            Registration form for INSTALL IT! Version 2.08.             ║
  1717.    ║                                                                        ║
  1718.    ╟────────────────────────────────────────────────────────────────────────╢
  1719.    ║                                                                        ║
  1720.    ║                 Name: _______________________________   Date _________ ║
  1721.    ║                Title: _______________________________                  ║
  1722.    ║                                                                        ║
  1723.    ║         Company Name: _______________________________                  ║
  1724.    ║              Address: _______________________________                  ║
  1725.    ║                       _______________________________                  ║
  1726.    ║ City, State, and Zip: _______________________________                  ║
  1727.    ║                                                                        ║
  1728.    ║                Phone: (      )  _____________________                  ║
  1729.    ║                                                                        ║
  1730.    ╟────────────────────────────────────────────────────────────────────────╢
  1731.    ║                                                                        ║
  1732.    ║ Check the boxes below to receive more information from group.m.        ║
  1733.    ║                                                                        ║
  1734.    ║ [ ] Please send me information on custom backgrounds for INSTALL.EXE.  ║
  1735.    ║ [ ] Please send me information on future releases of INSTALL IT!.      ║
  1736.    ║ [ ] Please send me information on other products from group.m.         ║
  1737.    ║                                                                        ║
  1738.    ╟────────────────────────────────────────────────────────────────────────╢
  1739.    ║                                                                        ║
  1740.    ║ How did you learn about this product?                                  ║
  1741.    ║ ______________________________________________________________________ ║
  1742.    ║ ______________________________________________________________________ ║
  1743.    ║                                                                        ║
  1744.    ╟────────────────────────────────────────────────────────────────────────╢
  1745.    ║                                                                        ║
  1746.    ║ How will you use this product?                                         ║
  1747.    ║ ______________________________________________________________________ ║
  1748.    ║ ______________________________________________________________________ ║
  1749.    ║                                                                        ║
  1750.    ║ Have you registered this use of INSTALL IT! before? [ ] Yes   [ ] No   ║
  1751.    ║ (If so, don't count any copies included in an earlier estimate.  Use   ║
  1752.    ║ negative numbers if revising downward.  See section "XI Registration") ║
  1753.    ║                                                                        ║
  1754.    ║ Approximately how many copies of INSTALL.EXE will you distribute? ____ ║
  1755.    ║                                                                        ║
  1756.    ╟────────────────────────────────────────────────────────────────────────╢
  1757.    ║                                                                        ║
  1758.    ║ Additional comments:                                                   ║
  1759.    ║ ______________________________________________________________________ ║
  1760.    ║ ______________________________________________________________________ ║
  1761.    ║ ______________________________________________________________________ ║
  1762.    ║ ______________________________________________________________________ ║
  1763.    ║ ______________________________________________________________________ ║
  1764.    ║                                                                        ║
  1765.    ╚════════════════════════════════════════════════════════════════════════╝
  1766.  
  1767.  
  1768.  
  1769.  
  1770.                                        30
  1771.  
  1772.  
  1773.      To send comments, complete the comment form below and mail to
  1774.  
  1775.           INSTALL IT! Comments
  1776.           group.m
  1777.           5800 Blue Spruce Ave.
  1778.           Alamosa, CO 81101-9738
  1779.  
  1780.           (719) 589-6602
  1781.  
  1782.  
  1783.    ╔════════════════════════════════════════════════════════#IN2080006══════╗
  1784.    ║                                                                        ║
  1785.    ║               Comment form for INSTALL IT! Version 2.08.               ║
  1786.    ║                                                                        ║
  1787.    ╟────────────────────────────────────────────────────────────────────────╢
  1788.    ║                                                                        ║
  1789.    ║                 Name: _______________________________   Date _________ ║
  1790.    ║                Title: _______________________________                  ║
  1791.    ║                                                                        ║
  1792.    ║         Company Name: _______________________________                  ║
  1793.    ║              Address: _______________________________                  ║
  1794.    ║                       _______________________________                  ║
  1795.    ║ City, State, and Zip: _______________________________                  ║
  1796.    ║                                                                        ║
  1797.    ║                Phone: (      )  _____________________                  ║
  1798.    ║                                                                        ║
  1799.    ╟────────────────────────────────────────────────────────────────────────╢
  1800.    ║                                                                        ║
  1801.    ║ Check the boxes below to receive more information from group.m.        ║
  1802.    ║                                                                        ║
  1803.    ║ [ ] Please send me information on custom backgrounds for INSTALL.EXE.  ║
  1804.    ║ [ ] Please send me information on future releases of INSTALL IT!.      ║
  1805.    ║ [ ] Please send me information on other products from group.m.         ║
  1806.    ║                                                                        ║
  1807.    ╟────────────────────────────────────────────────────────────────────────╢
  1808.    ║                                                                        ║
  1809.    ║ Comments:                                                              ║
  1810.    ║ ______________________________________________________________________ ║
  1811.    ║ ______________________________________________________________________ ║
  1812.    ║ ______________________________________________________________________ ║
  1813.    ║ ______________________________________________________________________ ║
  1814.    ║ ______________________________________________________________________ ║
  1815.    ║                                                                        ║
  1816.    ╚════════════════════════════════════════════════════════════════════════╝
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.                                        31
  1830.